<para>In this step, we use a GtkBuilder template to associate a
GtkBuilder ui file with our application window class.</para>
- <para>Our simple ui file puts a GtkHeaderBar on top of a GtkStack
- widget. The header bar contains a GtkStackSwitcher, which is a
- standalone widget to show a row of 'tabs' for the pages of a GtkStack.
+ <para>Our simple ui file gives the window a title, and puts a GtkStack
+ widget as the main content.
</para>
<informalexample>
<para>(<ulink url="https://gitlab.gnome.org/GNOME/gtk/blob/master/examples/application3/exampleappwin.c">full source</ulink>)</para>
</informalexample>
- <para>Note that we did not have to touch the stack switcher
- at all. It gets all its information from the stack that it
- belongs to. Here, we are passing the label to show for each
- file as the last argument to the gtk_stack_add_titled()
- function.</para>
+ <para>Lastly, we add a GtkStackSwitcher to the titlebar area
+ in the ui file, and we tell it to display information about our
+ stack.</para>
+
+ <para>The stack switcher gets all its information it needs to
+ display tabs from the stack that it belongs to. Here, we are
+ passing the label to show for each file as the last argument to
+ the gtk_stack_add_titled() function.</para>
<para>Our application is beginning to take shape:</para>
</section>
<section>
- <title>An application menu</title>
+ <title>A menu</title>
- <para>An application menu is shown by GNOME shell at the top of the
- screen. It is meant to collect infrequently used actions that affect
+ <para>The menu is shown at the right side of the headerbar.
+ It is meant to collect infrequently used actions that affect
the whole application.</para>
- <para>Just like the window template, we specify our application menu
+ <para>Just like the window template, we specify our menu
in a ui file, and add it as a resource to our binary.</para>
<informalexample>
- <programlisting><xi:include href="@SRC_DIR@/examples/application4/app-menu.ui" parse="text"><xi:fallback>MISSING XINCLUDE CONTENT</xi:fallback></xi:include></programlisting>
+ <programlisting><xi:include href="@SRC_DIR@/examples/application4/gears-menu.ui" parse="text"><xi:fallback>MISSING XINCLUDE CONTENT</xi:fallback></xi:include></programlisting>
</informalexample>
- <para>To associate the app menu with the application, we have to call
- gtk_application_set_app_menu(). Since app menus work by activating
- GActions, we also have to add a suitable set of actions to our
- application.</para>
+ <para>To make the menu appear, we have to load the ui file and
+ associate the resulting menu model with the menu button that we've
+ added to the headerbar. Since menus work by activating GActions,
+ we also have to add a suitable set of actions to our application.</para>
- <para>Both of these tasks are best done in the startup() vfunc,
+ <para>Adding the actions is best done in the startup() vfunc,
which is guaranteed to be called once for each primary application
instance:</para>
<informalexample>
gtk_application_set_accels_for_action (GTK_APPLICATION (app),
"app.quit",
quit_accels);
-
- builder = gtk_builder_new_from_resource ("/org/gtk/exampleapp/app-menu.ui");
- app_menu = G_MENU_MODEL (gtk_builder_get_object (builder, "appmenu"));
- gtk_application_set_app_menu (GTK_APPLICATION (app), app_menu);
- g_object_unref (builder);
}
static void
<title>Adding a search bar</title>
<para>We continue to flesh out the functionality of our application.
- For now, we add search. GTK supports this with #GtkSearchEntry and
+ For now, we add search. GTK supports this with GtkSearchEntry and
GtkSearchBar. The search bar is a widget that can slide in from the
top to present a search entry.</para>
</mediaobject>
</informalfigure>
</section>
- <section>
- <title>Header bar</title>
-
- <para>Our application already uses a GtkHeaderBar, but so far it
- still gets a 'normal' window titlebar on top of that. This is a
- bit redundant, and we will now tell GTK to use the header bar
- as replacement for the titlebar. To do so, we move it around to
- be a direct child of the window, and set its type to be titlebar.</para>
-
- <informalexample>
- <programlisting><xi:include href="@SRC_DIR@/examples/application10/window.ui" parse="text"><xi:fallback>MISSING XINCLUDE CONTENT</xi:fallback></xi:include></programlisting>
- </informalexample>
-
- <para>A small extra bonus of using a header bar is that we get
- a fallback application menu for free. Here is how the
- application now looks, if this fallback is used.</para>
-
- <informalfigure>
- <mediaobject>
- <imageobject>
- <imagedata fileref="getting-started-app10.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </informalfigure>
-
- <para>If we set up the window icon for our window, the menu button
- will use that instead of the generic placeholder icon you see
- here.</para>
- </section>
</section>
<section>
+Step 1: A trivial application
+
To make gnome-shell use the desktop file and icon for this example
while running it uninstalled, do the following:
+++ /dev/null
-CC ?= gcc
-PKGCONFIG = $(shell which pkg-config)
-CFLAGS = $(shell $(PKGCONFIG) --cflags gtk4)
-LIBS = $(shell $(PKGCONFIG) --libs gtk4)
-GLIB_COMPILE_RESOURCES = $(shell $(PKGCONFIG) --variable=glib_compile_resources gio-2.0)
-GLIB_COMPILE_SCHEMAS = $(shell $(PKGCONFIG) --variable=glib_compile_schemas gio-2.0)
-
-SRC = exampleapp.c exampleappwin.c exampleappprefs.c main.c
-BUILT_SRC = resources.c
-
-OBJS = $(BUILT_SRC:.c=.o) $(SRC:.c=.o)
-
-all: exampleapp
-
-org.gtk.exampleapp.gschema.valid: org.gtk.exampleapp.gschema.xml
- $(GLIB_COMPILE_SCHEMAS) --strict --dry-run --schema-file=$< && mkdir -p $(@D) && touch $@
-
-gschemas.compiled: org.gtk.exampleapp.gschema.valid
- $(GLIB_COMPILE_SCHEMAS) .
-
-resources.c: exampleapp.gresource.xml $(shell $(GLIB_COMPILE_RESOURCES) --sourcedir=. --generate-dependencies exampleapp.gresource.xml)
- $(GLIB_COMPILE_RESOURCES) exampleapp.gresource.xml --target=$@ --sourcedir=. --generate-source
-
-%.o: %.c
- $(CC) -c -o $(@F) $(CFLAGS) $<
-
-exampleapp: $(OBJS) gschemas.compiled
- $(CC) -o $(@F) $(OBJS) $(LIBS)
-
-clean:
- rm -f org.gtk.exampleapp.gschema.valid
- rm -f gschemas.compiled
- rm -f $(BUILT_SRC)
- rm -f $(OBJS)
- rm -f exampleapp
+++ /dev/null
-<interface>
- <menu id="appmenu">
- <section>
- <item>
- <attribute name="label" translatable="yes">_Preferences</attribute>
- <attribute name="action">app.preferences</attribute>
- </item>
- </section>
- <section>
- <item>
- <attribute name="label" translatable="yes">_Quit</attribute>
- <attribute name="action">app.quit</attribute>
- </item>
- </section>
- </menu>
-</interface>
+++ /dev/null
-#include <gtk/gtk.h>
-
-#include "exampleapp.h"
-#include "exampleappwin.h"
-#include "exampleappprefs.h"
-
-struct _ExampleApp
-{
- GtkApplication parent;
-};
-
-G_DEFINE_TYPE(ExampleApp, example_app, GTK_TYPE_APPLICATION);
-
-static void
-example_app_init (ExampleApp *app)
-{
-}
-
-static void
-preferences_activated (GSimpleAction *action,
- GVariant *parameter,
- gpointer app)
-{
- ExampleAppPrefs *prefs;
- GtkWindow *win;
-
- win = gtk_application_get_active_window (GTK_APPLICATION (app));
- prefs = example_app_prefs_new (EXAMPLE_APP_WINDOW (win));
- gtk_window_present (GTK_WINDOW (prefs));
-}
-
-static void
-quit_activated (GSimpleAction *action,
- GVariant *parameter,
- gpointer app)
-{
- g_application_quit (G_APPLICATION (app));
-}
-
-static GActionEntry app_entries[] =
-{
- { "preferences", preferences_activated, NULL, NULL, NULL },
- { "quit", quit_activated, NULL, NULL, NULL }
-};
-
-static void
-example_app_startup (GApplication *app)
-{
- GtkBuilder *builder;
- GMenuModel *app_menu;
- const gchar *quit_accels[2] = { "<Ctrl>Q", NULL };
-
- G_APPLICATION_CLASS (example_app_parent_class)->startup (app);
-
- g_action_map_add_action_entries (G_ACTION_MAP (app),
- app_entries, G_N_ELEMENTS (app_entries),
- app);
- gtk_application_set_accels_for_action (GTK_APPLICATION (app),
- "app.quit",
- quit_accels);
-
- builder = gtk_builder_new_from_resource ("/org/gtk/exampleapp/app-menu.ui");
- app_menu = G_MENU_MODEL (gtk_builder_get_object (builder, "appmenu"));
- gtk_application_set_app_menu (GTK_APPLICATION (app), app_menu);
- g_object_unref (builder);
-}
-
-static void
-example_app_activate (GApplication *app)
-{
- ExampleAppWindow *win;
-
- win = example_app_window_new (EXAMPLE_APP (app));
- gtk_window_present (GTK_WINDOW (win));
-}
-
-static void
-example_app_open (GApplication *app,
- GFile **files,
- gint n_files,
- const gchar *hint)
-{
- GList *windows;
- ExampleAppWindow *win;
- int i;
-
- windows = gtk_application_get_windows (GTK_APPLICATION (app));
- if (windows)
- win = EXAMPLE_APP_WINDOW (windows->data);
- else
- win = example_app_window_new (EXAMPLE_APP (app));
-
- for (i = 0; i < n_files; i++)
- example_app_window_open (win, files[i]);
-
- gtk_window_present (GTK_WINDOW (win));
-}
-
-static void
-example_app_class_init (ExampleAppClass *class)
-{
- G_APPLICATION_CLASS (class)->startup = example_app_startup;
- G_APPLICATION_CLASS (class)->activate = example_app_activate;
- G_APPLICATION_CLASS (class)->open = example_app_open;
-}
-
-ExampleApp *
-example_app_new (void)
-{
- return g_object_new (EXAMPLE_APP_TYPE,
- "application-id", "org.gtk.exampleapp",
- "flags", G_APPLICATION_HANDLES_OPEN,
- NULL);
-}
+++ /dev/null
-<?xml version="1.0" encoding="UTF-8"?>
-<gresources>
- <gresource prefix="/org/gtk/exampleapp">
- <file preprocess="xml-stripblanks">window.ui</file>
- <file preprocess="xml-stripblanks">app-menu.ui</file>
- <file preprocess="xml-stripblanks">gears-menu.ui</file>
- <file preprocess="xml-stripblanks">prefs.ui</file>
- </gresource>
-</gresources>
+++ /dev/null
-#ifndef __EXAMPLEAPP_H
-#define __EXAMPLEAPP_H
-
-#include <gtk/gtk.h>
-
-
-#define EXAMPLE_APP_TYPE (example_app_get_type ())
-G_DECLARE_FINAL_TYPE (ExampleApp, example_app, EXAMPLE, APP, GtkApplication)
-
-
-ExampleApp *example_app_new (void);
-
-
-#endif /* __EXAMPLEAPP_H */
+++ /dev/null
-#include <gtk/gtk.h>
-
-#include "exampleapp.h"
-#include "exampleappwin.h"
-#include "exampleappprefs.h"
-
-struct _ExampleAppPrefs
-{
- GtkDialog parent;
-
- GSettings *settings;
- GtkWidget *font;
- GtkWidget *transition;
-};
-
-G_DEFINE_TYPE (ExampleAppPrefs, example_app_prefs, GTK_TYPE_DIALOG)
-
-static void
-example_app_prefs_init (ExampleAppPrefs *prefs)
-{
- gtk_widget_init_template (GTK_WIDGET (prefs));
- prefs->settings = g_settings_new ("org.gtk.exampleapp");
-
- g_settings_bind (prefs->settings, "font",
- prefs->font, "font",
- G_SETTINGS_BIND_DEFAULT);
- g_settings_bind (prefs->settings, "transition",
- prefs->transition, "active-id",
- G_SETTINGS_BIND_DEFAULT);
-}
-
-static void
-example_app_prefs_dispose (GObject *object)
-{
- ExampleAppPrefs *prefs;
-
- prefs = EXAMPLE_APP_PREFS (object);
-
- g_clear_object (&prefs->settings);
-
- G_OBJECT_CLASS (example_app_prefs_parent_class)->dispose (object);
-}
-
-static void
-example_app_prefs_class_init (ExampleAppPrefsClass *class)
-{
- G_OBJECT_CLASS (class)->dispose = example_app_prefs_dispose;
-
- gtk_widget_class_set_template_from_resource (GTK_WIDGET_CLASS (class),
- "/org/gtk/exampleapp/prefs.ui");
- gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppPrefs, font);
- gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppPrefs, transition);
-}
-
-ExampleAppPrefs *
-example_app_prefs_new (ExampleAppWindow *win)
-{
- return g_object_new (EXAMPLE_APP_PREFS_TYPE, "transient-for", win, "use-header-bar", TRUE, NULL);
-}
+++ /dev/null
-#ifndef __EXAMPLEAPPPREFS_H
-#define __EXAMPLEAPPPREFS_H
-
-#include <gtk/gtk.h>
-#include "exampleappwin.h"
-
-
-#define EXAMPLE_APP_PREFS_TYPE (example_app_prefs_get_type ())
-G_DECLARE_FINAL_TYPE (ExampleAppPrefs, example_app_prefs, EXAMPLE, APP_PREFS, GtkDialog)
-
-
-ExampleAppPrefs *example_app_prefs_new (ExampleAppWindow *win);
-
-
-#endif /* __EXAMPLEAPPPREFS_H */
+++ /dev/null
-#include <gtk/gtk.h>
-
-#include "exampleapp.h"
-#include "exampleappwin.h"
-
-struct _ExampleAppWindow
-{
- GtkApplicationWindow parent;
-
- GSettings *settings;
- GtkWidget *stack;
- GtkWidget *search;
- GtkWidget *searchbar;
- GtkWidget *searchentry;
- GtkWidget *gears;
- GtkWidget *sidebar;
- GtkWidget *words;
- GtkWidget *lines;
- GtkWidget *lines_label;
-};
-
-G_DEFINE_TYPE (ExampleAppWindow, example_app_window, GTK_TYPE_APPLICATION_WINDOW)
-
-static void
-search_text_changed (GtkEntry *entry,
- ExampleAppWindow *win)
-{
- const gchar *text;
- GtkWidget *tab;
- GtkWidget *view;
- GtkTextBuffer *buffer;
- GtkTextIter start, match_start, match_end;
-
- text = gtk_editable_get_text (GTK_EDITABLE (entry));
-
- if (text[0] == '\0')
- return;
-
- tab = gtk_stack_get_visible_child (GTK_STACK (win->stack));
- view = gtk_scrolled_window_get_child (GTK_SCROLLED_WINDOW (tab));
- buffer = gtk_text_view_get_buffer (GTK_TEXT_VIEW (view));
-
- /* Very simple-minded search implementation */
- gtk_text_buffer_get_start_iter (buffer, &start);
- if (gtk_text_iter_forward_search (&start, text, GTK_TEXT_SEARCH_CASE_INSENSITIVE,
- &match_start, &match_end, NULL))
- {
- gtk_text_buffer_select_range (buffer, &match_start, &match_end);
- gtk_text_view_scroll_to_iter (GTK_TEXT_VIEW (view), &match_start,
- 0.0, FALSE, 0.0, 0.0);
- }
-}
-
-static void
-find_word (GtkButton *button,
- ExampleAppWindow *win)
-{
- const gchar *word;
-
- word = gtk_button_get_label (button);
- gtk_editable_set_text (GTK_EDITABLE (win->searchentry), word);
-}
-
-static void
-update_words (ExampleAppWindow *win)
-{
- GHashTable *strings;
- GHashTableIter iter;
- GtkWidget *tab, *view, *row;
- GtkTextBuffer *buffer;
- GtkTextIter start, end;
- GList *children, *l;
- gchar *word, *key;
-
- tab = gtk_stack_get_visible_child (GTK_STACK (win->stack));
-
- if (tab == NULL)
- return;
-
- view = gtk_scrolled_window_get_child (GTK_SCROLLED_WINDOW (tab));
- buffer = gtk_text_view_get_buffer (GTK_TEXT_VIEW (view));
-
- strings = g_hash_table_new_full (g_str_hash, g_str_equal, g_free, NULL);
-
- gtk_text_buffer_get_start_iter (buffer, &start);
- while (!gtk_text_iter_is_end (&start))
- {
- while (!gtk_text_iter_starts_word (&start))
- {
- if (!gtk_text_iter_forward_char (&start))
- goto done;
- }
- end = start;
- if (!gtk_text_iter_forward_word_end (&end))
- goto done;
- word = gtk_text_buffer_get_text (buffer, &start, &end, FALSE);
- g_hash_table_add (strings, g_utf8_strdown (word, -1));
- g_free (word);
- start = end;
- }
-
-done:
- children = gtk_container_get_children (GTK_CONTAINER (win->words));
- for (l = children; l; l = l->next)
- gtk_container_remove (GTK_CONTAINER (win->words), GTK_WIDGET (l->data));
- g_list_free (children);
-
- g_hash_table_iter_init (&iter, strings);
- while (g_hash_table_iter_next (&iter, (gpointer *)&key, NULL))
- {
- row = gtk_button_new_with_label (key);
- g_signal_connect (row, "clicked",
- G_CALLBACK (find_word), win);
- gtk_container_add (GTK_CONTAINER (win->words), row);
- }
-
- g_hash_table_unref (strings);
-}
-
-static void
-update_lines (ExampleAppWindow *win)
-{
- GtkWidget *tab, *view;
- GtkTextBuffer *buffer;
- int count;
- gchar *lines;
-
- tab = gtk_stack_get_visible_child (GTK_STACK (win->stack));
-
- if (tab == NULL)
- return;
-
- view = gtk_scrolled_window_get_child (GTK_SCROLLED_WINDOW (tab));
- buffer = gtk_text_view_get_buffer (GTK_TEXT_VIEW (view));
-
- count = gtk_text_buffer_get_line_count (buffer);
- lines = g_strdup_printf ("%d", count);
- gtk_label_set_text (GTK_LABEL (win->lines), lines);
- g_free (lines);
-}
-
-static void
-visible_child_changed (GObject *stack,
- GParamSpec *pspec,
- ExampleAppWindow *win)
-{
- if (gtk_widget_in_destruction (GTK_WIDGET (stack)))
- return;
-
- gtk_search_bar_set_search_mode (GTK_SEARCH_BAR (win->searchbar), FALSE);
- update_words (win);
- update_lines (win);
-}
-
-static void
-words_changed (GObject *sidebar,
- GParamSpec *pspec,
- ExampleAppWindow *win)
-{
- update_words (win);
-}
-
-static void
-example_app_window_init (ExampleAppWindow *win)
-{
- GtkBuilder *builder;
- GMenuModel *menu;
- GAction *action;
-
- gtk_widget_init_template (GTK_WIDGET (win));
- win->settings = g_settings_new ("org.gtk.exampleapp");
-
- g_settings_bind (win->settings, "transition",
- win->stack, "transition-type",
- G_SETTINGS_BIND_DEFAULT);
-
- g_settings_bind (win->settings, "show-words",
- win->sidebar, "reveal-child",
- G_SETTINGS_BIND_DEFAULT);
-
- g_object_bind_property (win->search, "active",
- win->searchbar, "search-mode-enabled",
- G_BINDING_BIDIRECTIONAL);
-
- g_signal_connect (win->sidebar, "notify::reveal-child",
- G_CALLBACK (words_changed), win);
-
- builder = gtk_builder_new_from_resource ("/org/gtk/exampleapp/gears-menu.ui");
- menu = G_MENU_MODEL (gtk_builder_get_object (builder, "menu"));
- gtk_menu_button_set_menu_model (GTK_MENU_BUTTON (win->gears), menu);
- g_object_unref (builder);
-
- action = g_settings_create_action (win->settings, "show-words");
- g_action_map_add_action (G_ACTION_MAP (win), action);
- g_object_unref (action);
-
- action = (GAction*) g_property_action_new ("show-lines", win->lines, "visible");
- g_action_map_add_action (G_ACTION_MAP (win), action);
- g_object_unref (action);
-
- g_object_bind_property (win->lines, "visible",
- win->lines_label, "visible",
- G_BINDING_DEFAULT);
-
- g_object_set (gtk_settings_get_default (), "gtk-shell-shows-app-menu", FALSE, NULL);
- gtk_application_window_set_show_menubar (GTK_APPLICATION_WINDOW (win), TRUE);
-}
-
-static void
-example_app_window_dispose (GObject *object)
-{
- ExampleAppWindow *win;
-
- win = EXAMPLE_APP_WINDOW (object);
-
- g_clear_object (&win->settings);
-
- G_OBJECT_CLASS (example_app_window_parent_class)->dispose (object);
-}
-
-static void
-example_app_window_class_init (ExampleAppWindowClass *class)
-{
- G_OBJECT_CLASS (class)->dispose = example_app_window_dispose;
-
- gtk_widget_class_set_template_from_resource (GTK_WIDGET_CLASS (class),
- "/org/gtk/exampleapp/window.ui");
-
- gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, stack);
- gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, search);
- gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, searchbar);
- gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, searchentry);
- gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, gears);
- gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, words);
- gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, sidebar);
- gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, lines);
- gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, lines_label);
-
- gtk_widget_class_bind_template_callback (GTK_WIDGET_CLASS (class), search_text_changed);
- gtk_widget_class_bind_template_callback (GTK_WIDGET_CLASS (class), visible_child_changed);
-}
-
-ExampleAppWindow *
-example_app_window_new (ExampleApp *app)
-{
- return g_object_new (EXAMPLE_APP_WINDOW_TYPE, "application", app, NULL);
-}
-
-void
-example_app_window_open (ExampleAppWindow *win,
- GFile *file)
-{
- gchar *basename;
- GtkWidget *scrolled, *view;
- gchar *contents;
- gsize length;
- GtkTextBuffer *buffer;
- GtkTextTag *tag;
- GtkTextIter start_iter, end_iter;
-
- basename = g_file_get_basename (file);
-
- scrolled = gtk_scrolled_window_new (NULL, NULL);
- gtk_widget_set_hexpand (scrolled, TRUE);
- gtk_widget_set_vexpand (scrolled, TRUE);
- view = gtk_text_view_new ();
- gtk_text_view_set_editable (GTK_TEXT_VIEW (view), FALSE);
- gtk_text_view_set_cursor_visible (GTK_TEXT_VIEW (view), FALSE);
- gtk_scrolled_window_set_child (GTK_SCROLLED_WINDOW (scrolled), view);
- gtk_stack_add_titled (GTK_STACK (win->stack), scrolled, basename, basename);
-
- buffer = gtk_text_view_get_buffer (GTK_TEXT_VIEW (view));
-
- if (g_file_load_contents (file, NULL, &contents, &length, NULL, NULL))
- {
- gtk_text_buffer_set_text (buffer, contents, length);
- g_free (contents);
- }
-
- tag = gtk_text_buffer_create_tag (buffer, NULL, NULL);
- g_settings_bind (win->settings, "font",
- tag, "font",
- G_SETTINGS_BIND_DEFAULT);
-
- gtk_text_buffer_get_start_iter (buffer, &start_iter);
- gtk_text_buffer_get_end_iter (buffer, &end_iter);
- gtk_text_buffer_apply_tag (buffer, tag, &start_iter, &end_iter);
-
- g_free (basename);
-
- gtk_widget_set_sensitive (win->search, TRUE);
-
- update_words (win);
- update_lines (win);
-}
+++ /dev/null
-#ifndef __EXAMPLEAPPWIN_H
-#define __EXAMPLEAPPWIN_H
-
-#include <gtk/gtk.h>
-#include "exampleapp.h"
-
-
-#define EXAMPLE_APP_WINDOW_TYPE (example_app_window_get_type ())
-G_DECLARE_FINAL_TYPE (ExampleAppWindow, example_app_window, EXAMPLE, APP_WINDOW, GtkApplicationWindow)
-
-ExampleAppWindow *example_app_window_new (ExampleApp *app);
-void example_app_window_open (ExampleAppWindow *win,
- GFile *file);
-
-
-#endif /* __EXAMPLEAPPWIN_H */
+++ /dev/null
-<interface>
- <menu id="menu">
- <section>
- <item>
- <attribute name="label" translatable="yes">_Words</attribute>
- <attribute name="action">win.show-words</attribute>
- </item>
- <item>
- <attribute name="label" translatable="yes">_Lines</attribute>
- <attribute name="action">win.show-lines</attribute>
- </item>
- </section>
- </menu>
-</interface>
+++ /dev/null
-#include <gtk/gtk.h>
-
-#include "exampleapp.h"
-
-int
-main (int argc, char *argv[])
-{
- /* Since this example is running uninstalled,
- * we have to help it find its schema. This
- * is *not* necessary in properly installed
- * application.
- */
- g_setenv ("GSETTINGS_SCHEMA_DIR", ".", FALSE);
-
- return g_application_run (G_APPLICATION (example_app_new ()), argc, argv);
-}
+++ /dev/null
-app10_resources = gnome.compile_resources('exampleapp10 resources',
- 'exampleapp.gresource.xml',
- source_dir: '.')
-
-app10_schemas = gnome.compile_schemas()
-
-executable('exampleapp10',
- 'main.c',
- 'exampleapp.c',
- 'exampleappwin.c',
- 'exampleappprefs.c',
- app10_resources,
- app10_schemas,
- dependencies: libgtk_dep)
+++ /dev/null
-<?xml version="1.0" encoding="UTF-8"?>
-<schemalist>
- <schema path="/org/gtk/exampleapp/" id="org.gtk.exampleapp">
- <key name="font" type="s">
- <default>'Monospace 12'</default>
- <summary>Font</summary>
- <description>The font to be used for content.</description>
- </key>
- <key name="transition" type="s">
- <choices>
- <choice value='none'/>
- <choice value='crossfade'/>
- <choice value='slide-left-right'/>
- </choices>
- <default>'none'</default>
- <summary>Transition</summary>
- <description>The transition to use when switching tabs.</description>
- </key>
- <key name="show-words" type="b">
- <default>false</default>
- <summary>Show words</summary>
- <description>Whether to show a word list in the sidebar</description>
- </key>
- </schema>
-</schemalist>
+++ /dev/null
-<?xml version="1.0" encoding="UTF-8"?>
-<interface>
- <template class="ExampleAppPrefs" parent="GtkDialog">
- <property name="title" translatable="yes">Preferences</property>
- <property name="resizable">0</property>
- <property name="modal">1</property>
- <child internal-child="vbox">
- <object class="GtkBox" id="vbox">
- <child>
- <object class="GtkGrid" id="grid">
- <property name="margin-start">6</property>
- <property name="margin-end">6</property>
- <property name="margin-top">6</property>
- <property name="margin-bottom">6</property>
- <property name="row-spacing">12</property>
- <property name="column-spacing">6</property>
- <child>
- <object class="GtkLabel" id="fontlabel">
- <property name="label">_Font:</property>
- <property name="use-underline">1</property>
- <property name="mnemonic-widget">font</property>
- <property name="xalign">1</property>
- <layout>
- <property name="left-attach">0</property>
- <property name="top-attach">0</property>
- </layout>
- </object>
- </child>
- <child>
- <object class="GtkFontButton" id="font">
- <layout>
- <property name="left-attach">1</property>
- <property name="top-attach">0</property>
- </layout>
- </object>
- </child>
- <child>
- <object class="GtkLabel" id="transitionlabel">
- <property name="label">_Transition:</property>
- <property name="use-underline">1</property>
- <property name="mnemonic-widget">transition</property>
- <property name="xalign">1</property>
- <layout>
- <property name="left-attach">0</property>
- <property name="top-attach">1</property>
- </layout>
- </object>
- </child>
- <child>
- <object class="GtkComboBoxText" id="transition">
- <items>
- <item translatable="yes" id="none">None</item>
- <item translatable="yes" id="crossfade">Fade</item>
- <item translatable="yes" id="slide-left-right">Slide</item>
- </items>
- <layout>
- <property name="left-attach">1</property>
- <property name="top-attach">1</property>
- </layout>
- </object>
- </child>
- </object>
- </child>
- </object>
- </child>
- </template>
-</interface>
+++ /dev/null
-<?xml version="1.0" encoding="UTF-8"?>
-<interface>
- <template class="ExampleAppWindow" parent="GtkApplicationWindow">
- <property name="title" translatable="yes">Example Application</property>
- <property name="default-width">600</property>
- <property name="default-height">400</property>
- <child type="titlebar">
- <object class="GtkHeaderBar" id="header">
- <property name="show-title-buttons">1</property>
- <child>
- <object class="GtkLabel" id="lines_label">
- <property name="visible">0</property>
- <property name="label" translatable="yes">Lines:</property>
- </object>
- </child>
- <child>
- <object class="GtkLabel" id="lines">
- <property name="visible">0</property>
- </object>
- </child>
- <child type="title">
- <object class="GtkStackSwitcher" id="tabs">
- <property name="stack">stack</property>
- </object>
- </child>
- <child type="end">
- <object class="GtkToggleButton" id="search">
- <property name="sensitive">0</property>
- <property name="icon-name">edit-find-symbolic</property>
- </object>
- </child>
- <child type="end">
- <object class="GtkMenuButton" id="gears">
- <property name="direction">none</property>
- <style>
- <class name="image-button"/>
- </style>
- </object>
- </child>
- </object>
- </child>
- <child>
- <object class="GtkBox" id="content_box">
- <property name="orientation">vertical</property>
- <child>
- <object class="GtkSearchBar" id="searchbar">
- <child>
- <object class="GtkSearchEntry" id="searchentry">
- <signal name="search-changed" handler="search_text_changed"/>
- </object>
- </child>
- </object>
- </child>
- <child>
- <object class="GtkBox" id="hbox">
- <child>
- <object class="GtkRevealer" id="sidebar">
- <property name="transition-type">slide-right</property>
- <child>
- <object class="GtkScrolledWindow" id="sidebar-sw">
- <property name="hscrollbar-policy">never</property>
- <child>
- <object class="GtkListBox" id="words">
- <property name="selection-mode">none</property>
- </object>
- </child>
- </object>
- </child>
- </object>
- </child>
- <child>
- <object class="GtkStack" id="stack">
- <signal name="notify::visible-child" handler="visible_child_changed"/>
- </object>
- </child>
- </object>
- </child>
- </object>
- </child>
- </template>
-</interface>
--- /dev/null
+Step 2: Populating the window
+<?xml version="1.0" encoding="UTF-8"?>
<interface>
<template class="ExampleAppWindow" parent="GtkApplicationWindow">
<property name="title" translatable="yes">Example Application</property>
<child>
<object class="GtkBox" id="content_box">
<property name="orientation">vertical</property>
- <child>
- <object class="GtkHeaderBar" id="header">
- <child type="title">
- <object class="GtkStackSwitcher" id="tabs">
- <property name="stack">stack</property>
- </object>
- </child>
- </object>
- </child>
<child>
<object class="GtkStack" id="stack"/>
</child>
--- /dev/null
+Step 3: Opening files, add a stack switcher
+<?xml version="1.0" encoding="UTF-8"?>
<interface>
<template class="ExampleAppWindow" parent="GtkApplicationWindow">
<property name="title" translatable="yes">Example Application</property>
<property name="default-width">600</property>
<property name="default-height">400</property>
+ <child type="titlebar">
+ <object class="GtkHeaderBar" id="header">
+ <property name="show-title-buttons">1</property>
+ <child type="title">
+ <object class="GtkStackSwitcher" id="tabs">
+ <property name="stack">stack</property>
+ </object>
+ </child>
+ </object>
+ </child>
<child>
<object class="GtkBox" id="content_box">
<property name="orientation">vertical</property>
- <child>
- <object class="GtkHeaderBar" id="header">
- <child type="title">
- <object class="GtkStackSwitcher" id="tabs">
- <property name="stack">stack</property>
- </object>
- </child>
- </object>
- </child>
<child>
<object class="GtkStack" id="stack"/>
</child>
--- /dev/null
+Step 4: Add a menu
+++ /dev/null
-<interface>
- <menu id="appmenu">
- <section>
- <item>
- <attribute name="label" translatable="yes">_Preferences</attribute>
- <attribute name="action">app.preferences</attribute>
- </item>
- </section>
- <section>
- <item>
- <attribute name="label" translatable="yes">_Quit</attribute>
- <attribute name="action">app.quit</attribute>
- </item>
- </section>
- </menu>
-</interface>
static void
example_app_startup (GApplication *app)
{
- GtkBuilder *builder;
- GMenuModel *app_menu;
const gchar *quit_accels[2] = { "<Ctrl>Q", NULL };
G_APPLICATION_CLASS (example_app_parent_class)->startup (app);
gtk_application_set_accels_for_action (GTK_APPLICATION (app),
"app.quit",
quit_accels);
-
- builder = gtk_builder_new_from_resource ("/org/gtk/exampleapp/app-menu.ui");
- app_menu = G_MENU_MODEL (gtk_builder_get_object (builder, "appmenu"));
- gtk_application_set_app_menu (GTK_APPLICATION (app), app_menu);
- g_object_unref (builder);
}
static void
<gresources>
<gresource prefix="/org/gtk/exampleapp">
<file preprocess="xml-stripblanks">window.ui</file>
- <file preprocess="xml-stripblanks">app-menu.ui</file>
+ <file preprocess="xml-stripblanks">gears-menu.ui</file>
</gresource>
</gresources>
GtkApplicationWindow parent;
GtkWidget *stack;
+ GtkWidget *gears;
};
G_DEFINE_TYPE (ExampleAppWindow, example_app_window, GTK_TYPE_APPLICATION_WINDOW)
static void
example_app_window_init (ExampleAppWindow *win)
{
+ GtkBuilder *builder;
+ GMenuModel *menu;
+
gtk_widget_init_template (GTK_WIDGET (win));
+
+ builder = gtk_builder_new_from_resource ("/org/gtk/exampleapp/gears-menu.ui");
+ menu = G_MENU_MODEL (gtk_builder_get_object (builder, "menu"));
+ gtk_menu_button_set_menu_model (GTK_MENU_BUTTON (win->gears), menu);
+ g_object_unref (builder);
}
static void
gtk_widget_class_set_template_from_resource (GTK_WIDGET_CLASS (class),
"/org/gtk/exampleapp/window.ui");
gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, stack);
+ gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, gears);
}
ExampleAppWindow *
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+<interface>
+ <menu id="menu">
+ <section>
+ <item>
+ <attribute name="label" translatable="yes">_Preferences</attribute>
+ <attribute name="action">app.preferences</attribute>
+ </item>
+ </section>
+ <section>
+ <item>
+ <attribute name="label" translatable="yes">_Quit</attribute>
+ <attribute name="action">app.quit</attribute>
+ </item>
+ </section>
+ </menu>
+</interface>
+<?xml version="1.0" encoding="UTF-8"?>
<interface>
<template class="ExampleAppWindow" parent="GtkApplicationWindow">
<property name="title" translatable="yes">Example Application</property>
<property name="default-width">600</property>
<property name="default-height">400</property>
+ <child type="titlebar">
+ <object class="GtkHeaderBar" id="header">
+ <property name="show-title-buttons">1</property>
+ <child type="title">
+ <object class="GtkStackSwitcher" id="tabs">
+ <property name="stack">stack</property>
+ </object>
+ </child>
+ <child type="end">
+ <object class="GtkMenuButton" id="gears">
+ <property name="direction">none</property>
+ </object>
+ </child>
+ </object>
+ </child>
<child>
<object class="GtkBox" id="content_box">
<property name="orientation">vertical</property>
- <child>
- <object class="GtkHeaderBar" id="header">
- <child type="title">
- <object class="GtkStackSwitcher" id="tabs">
- <property name="stack">stack</property>
- </object>
- </child>
- </object>
- </child>
<child>
<object class="GtkStack" id="stack"/>
</child>
+++ /dev/null
-<interface>
- <menu id="appmenu">
- <section>
- <item>
- <attribute name="label" translatable="yes">_Preferences</attribute>
- <attribute name="action">app.preferences</attribute>
- </item>
- </section>
- <section>
- <item>
- <attribute name="label" translatable="yes">_Quit</attribute>
- <attribute name="action">app.quit</attribute>
- </item>
- </section>
- </menu>
-</interface>
static void
example_app_startup (GApplication *app)
{
- GtkBuilder *builder;
- GMenuModel *app_menu;
const gchar *quit_accels[2] = { "<Ctrl>Q", NULL };
G_APPLICATION_CLASS (example_app_parent_class)->startup (app);
gtk_application_set_accels_for_action (GTK_APPLICATION (app),
"app.quit",
quit_accels);
-
- builder = gtk_builder_new_from_resource ("/org/gtk/exampleapp/app-menu.ui");
- app_menu = G_MENU_MODEL (gtk_builder_get_object (builder, "appmenu"));
- gtk_application_set_app_menu (GTK_APPLICATION (app), app_menu);
- g_object_unref (builder);
}
static void
<gresources>
<gresource prefix="/org/gtk/exampleapp">
<file preprocess="xml-stripblanks">window.ui</file>
- <file preprocess="xml-stripblanks">app-menu.ui</file>
+ <file preprocess="xml-stripblanks">gears-menu.ui</file>
</gresource>
</gresources>
GSettings *settings;
GtkWidget *stack;
+ GtkWidget *gears;
};
G_DEFINE_TYPE (ExampleAppWindow, example_app_window, GTK_TYPE_APPLICATION_WINDOW)
static void
example_app_window_init (ExampleAppWindow *win)
{
+ GtkBuilder *builder;
+ GMenuModel *menu;
+
gtk_widget_init_template (GTK_WIDGET (win));
- win->settings = g_settings_new ("org.gtk.exampleapp");
+ builder = gtk_builder_new_from_resource ("/org/gtk/exampleapp/gears-menu.ui");
+ menu = G_MENU_MODEL (gtk_builder_get_object (builder, "menu"));
+ gtk_menu_button_set_menu_model (GTK_MENU_BUTTON (win->gears), menu);
+ g_object_unref (builder);
+
+ win->settings = g_settings_new ("org.gtk.exampleapp");
g_settings_bind (win->settings, "transition",
win->stack, "transition-type",
G_SETTINGS_BIND_DEFAULT);
gtk_widget_class_set_template_from_resource (GTK_WIDGET_CLASS (class),
"/org/gtk/exampleapp/window.ui");
gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, stack);
+ gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, gears);
}
ExampleAppWindow *
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+<interface>
+ <menu id="menu">
+ <section>
+ <item>
+ <attribute name="label" translatable="yes">_Preferences</attribute>
+ <attribute name="action">app.preferences</attribute>
+ </item>
+ </section>
+ <section>
+ <item>
+ <attribute name="label" translatable="yes">_Quit</attribute>
+ <attribute name="action">app.quit</attribute>
+ </item>
+ </section>
+ </menu>
+</interface>
+<?xml version="1.0" encoding="UTF-8"?>
<interface>
<template class="ExampleAppWindow" parent="GtkApplicationWindow">
<property name="title" translatable="yes">Example Application</property>
<property name="default-width">600</property>
<property name="default-height">400</property>
+ <child type="titlebar">
+ <object class="GtkHeaderBar" id="header">
+ <property name="show-title-buttons">1</property>
+ <child type="title">
+ <object class="GtkStackSwitcher" id="tabs">
+ <property name="stack">stack</property>
+ </object>
+ </child>
+ <child type="end">
+ <object class="GtkMenuButton" id="gears">
+ <property name="direction">none</property>
+ </object>
+ </child>
+ </object>
+ </child>
<child>
<object class="GtkBox" id="content_box">
<property name="orientation">vertical</property>
- <child>
- <object class="GtkHeaderBar" id="header">
- <child type="title">
- <object class="GtkStackSwitcher" id="tabs">
- <property name="stack">stack</property>
- </object>
- </child>
- </object>
- </child>
<child>
<object class="GtkStack" id="stack"/>
</child>
+++ /dev/null
-<interface>
- <menu id="appmenu">
- <section>
- <item>
- <attribute name="label" translatable="yes">_Preferences</attribute>
- <attribute name="action">app.preferences</attribute>
- </item>
- </section>
- <section>
- <item>
- <attribute name="label" translatable="yes">_Quit</attribute>
- <attribute name="action">app.quit</attribute>
- </item>
- </section>
- </menu>
-</interface>
static void
example_app_startup (GApplication *app)
{
- GtkBuilder *builder;
- GMenuModel *app_menu;
const gchar *quit_accels[2] = { "<Ctrl>Q", NULL };
G_APPLICATION_CLASS (example_app_parent_class)->startup (app);
gtk_application_set_accels_for_action (GTK_APPLICATION (app),
"app.quit",
quit_accels);
-
- builder = gtk_builder_new_from_resource ("/org/gtk/exampleapp/app-menu.ui");
- app_menu = G_MENU_MODEL (gtk_builder_get_object (builder, "appmenu"));
- gtk_application_set_app_menu (GTK_APPLICATION (app), app_menu);
- g_object_unref (builder);
}
static void
<gresources>
<gresource prefix="/org/gtk/exampleapp">
<file preprocess="xml-stripblanks">window.ui</file>
- <file preprocess="xml-stripblanks">app-menu.ui</file>
+ <file preprocess="xml-stripblanks">gears-menu.ui</file>
<file preprocess="xml-stripblanks">prefs.ui</file>
</gresource>
</gresources>
GSettings *settings;
GtkWidget *stack;
+ GtkWidget *gears;
};
G_DEFINE_TYPE (ExampleAppWindow, example_app_window, GTK_TYPE_APPLICATION_WINDOW)
static void
example_app_window_init (ExampleAppWindow *win)
{
+ GtkBuilder *builder;
+ GMenuModel *menu;
+
gtk_widget_init_template (GTK_WIDGET (win));
+
+ builder = gtk_builder_new_from_resource ("/org/gtk/exampleapp/gears-menu.ui");
+ menu = G_MENU_MODEL (gtk_builder_get_object (builder, "menu"));
+ gtk_menu_button_set_menu_model (GTK_MENU_BUTTON (win->gears), menu);
+ g_object_unref (builder);
+
win->settings = g_settings_new ("org.gtk.exampleapp");
g_settings_bind (win->settings, "transition",
gtk_widget_class_set_template_from_resource (GTK_WIDGET_CLASS (class),
"/org/gtk/exampleapp/window.ui");
gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, stack);
+ gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, gears);
}
ExampleAppWindow *
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+<interface>
+ <menu id="menu">
+ <section>
+ <item>
+ <attribute name="label" translatable="yes">_Preferences</attribute>
+ <attribute name="action">app.preferences</attribute>
+ </item>
+ </section>
+ <section>
+ <item>
+ <attribute name="label" translatable="yes">_Quit</attribute>
+ <attribute name="action">app.quit</attribute>
+ </item>
+ </section>
+ </menu>
+</interface>
<property name="title" translatable="yes">Preferences</property>
<property name="resizable">0</property>
<property name="modal">1</property>
- <child internal-child="vbox">
- <object class="GtkBox" id="vbox">
+ <child internal-child="content_area">
+ <object class="GtkBox" id="content_area">
<child>
<object class="GtkGrid" id="grid">
- <property name="margin-start">6</property>
- <property name="margin-end">6</property>
- <property name="margin-top">6</property>
- <property name="margin-bottom">6</property>
+ <property name="margin-start">12</property>
+ <property name="margin-end">12</property>
+ <property name="margin-top">12</property>
+ <property name="margin-bottom">12</property>
<property name="row-spacing">12</property>
- <property name="column-spacing">6</property>
+ <property name="column-spacing">12</property>
<child>
<object class="GtkLabel" id="fontlabel">
<property name="label">_Font:</property>
+<?xml version="1.0" encoding="UTF-8"?>
<interface>
<template class="ExampleAppWindow" parent="GtkApplicationWindow">
<property name="title" translatable="yes">Example Application</property>
<property name="default-width">600</property>
<property name="default-height">400</property>
+ <child type="titlebar">
+ <object class="GtkHeaderBar" id="header">
+ <property name="show-title-buttons">1</property>
+ <child type="title">
+ <object class="GtkStackSwitcher" id="tabs">
+ <property name="stack">stack</property>
+ </object>
+ </child>
+ <child type="end">
+ <object class="GtkMenuButton" id="gears">
+ <property name="direction">none</property>
+ </object>
+ </child>
+ </object>
+ </child>
<child>
<object class="GtkBox" id="content_box">
<property name="orientation">vertical</property>
- <child>
- <object class="GtkHeaderBar" id="header">
- <child type="title">
- <object class="GtkStackSwitcher" id="tabs">
- <property name="stack">stack</property>
- </object>
- </child>
- </object>
- </child>
<child>
<object class="GtkStack" id="stack"/>
</child>
--- /dev/null
+Step 7: A search bar
+++ /dev/null
-<interface>
- <menu id="appmenu">
- <section>
- <item>
- <attribute name="label" translatable="yes">_Preferences</attribute>
- <attribute name="action">app.preferences</attribute>
- </item>
- </section>
- <section>
- <item>
- <attribute name="label" translatable="yes">_Quit</attribute>
- <attribute name="action">app.quit</attribute>
- </item>
- </section>
- </menu>
-</interface>
static void
example_app_startup (GApplication *app)
{
- GtkBuilder *builder;
- GMenuModel *app_menu;
const gchar *quit_accels[2] = { "<Ctrl>Q", NULL };
G_APPLICATION_CLASS (example_app_parent_class)->startup (app);
gtk_application_set_accels_for_action (GTK_APPLICATION (app),
"app.quit",
quit_accels);
-
- builder = gtk_builder_new_from_resource ("/org/gtk/exampleapp/app-menu.ui");
- app_menu = G_MENU_MODEL (gtk_builder_get_object (builder, "appmenu"));
- gtk_application_set_app_menu (GTK_APPLICATION (app), app_menu);
- g_object_unref (builder);
}
static void
<gresources>
<gresource prefix="/org/gtk/exampleapp">
<file preprocess="xml-stripblanks">window.ui</file>
- <file preprocess="xml-stripblanks">app-menu.ui</file>
+ <file preprocess="xml-stripblanks">gears-menu.ui</file>
<file preprocess="xml-stripblanks">prefs.ui</file>
</gresource>
</gresources>
GSettings *settings;
GtkWidget *stack;
+ GtkWidget *gears;
GtkWidget *search;
GtkWidget *searchbar;
};
static void
example_app_window_init (ExampleAppWindow *win)
{
+ GtkBuilder *builder;
+ GMenuModel *menu;
+
gtk_widget_init_template (GTK_WIDGET (win));
+
+ builder = gtk_builder_new_from_resource ("/org/gtk/exampleapp/gears-menu.ui");
+ menu = G_MENU_MODEL (gtk_builder_get_object (builder, "menu"));
+ gtk_menu_button_set_menu_model (GTK_MENU_BUTTON (win->gears), menu);
+ g_object_unref (builder);
+
win->settings = g_settings_new ("org.gtk.exampleapp");
g_settings_bind (win->settings, "transition",
"/org/gtk/exampleapp/window.ui");
gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, stack);
+ gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, gears);
gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, search);
gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, searchbar);
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+<interface>
+ <menu id="menu">
+ <section>
+ <item>
+ <attribute name="label" translatable="yes">_Preferences</attribute>
+ <attribute name="action">app.preferences</attribute>
+ </item>
+ </section>
+ <section>
+ <item>
+ <attribute name="label" translatable="yes">_Quit</attribute>
+ <attribute name="action">app.quit</attribute>
+ </item>
+ </section>
+ </menu>
+</interface>
<property name="title" translatable="yes">Preferences</property>
<property name="resizable">0</property>
<property name="modal">1</property>
- <child internal-child="vbox">
- <object class="GtkBox" id="vbox">
+ <child internal-child="content_area">
+ <object class="GtkBox" id="content_area">
<child>
<object class="GtkGrid" id="grid">
- <property name="margin-start">6</property>
- <property name="margin-end">6</property>
- <property name="margin-top">6</property>
- <property name="margin-bottom">6</property>
+ <property name="margin-start">12</property>
+ <property name="margin-end">12</property>
+ <property name="margin-top">12</property>
+ <property name="margin-bottom">12</property>
<property name="row-spacing">12</property>
- <property name="column-spacing">6</property>
+ <property name="column-spacing">12</property>
<child>
<object class="GtkLabel" id="fontlabel">
<property name="label">_Font:</property>
<property name="title" translatable="yes">Example Application</property>
<property name="default-width">600</property>
<property name="default-height">400</property>
+ <child type="titlebar">
+ <object class="GtkHeaderBar" id="header">
+ <property name="show-title-buttons">1</property>
+ <child type="title">
+ <object class="GtkStackSwitcher" id="tabs">
+ <property name="stack">stack</property>
+ </object>
+ </child>
+ <child type="end">
+ <object class="GtkMenuButton" id="gears">
+ <property name="direction">none</property>
+ </object>
+ </child>
+ <child type="end">
+ <object class="GtkToggleButton" id="search">
+ <property name="sensitive">0</property>
+ <property name="icon-name">edit-find-symbolic</property>
+ </object>
+ </child>
+ </object>
+ </child>
<child>
<object class="GtkBox" id="content_box">
<property name="orientation">vertical</property>
- <child>
- <object class="GtkHeaderBar" id="header">
- <child type="title">
- <object class="GtkStackSwitcher" id="tabs">
- <property name="stack">stack</property>
- </object>
- </child>
- <child type="end">
- <object class="GtkToggleButton" id="search">
- <property name="sensitive">0</property>
- <property name="icon-name">edit-find-symbolic</property>
- </object>
- </child>
- </object>
- </child>
<child>
<object class="GtkSearchBar" id="searchbar">
<child>
--- /dev/null
+Step 8: Adding a sidebar
+++ /dev/null
-<interface>
- <menu id="appmenu">
- <section>
- <item>
- <attribute name="label" translatable="yes">_Preferences</attribute>
- <attribute name="action">app.preferences</attribute>
- </item>
- </section>
- <section>
- <item>
- <attribute name="label" translatable="yes">_Quit</attribute>
- <attribute name="action">app.quit</attribute>
- </item>
- </section>
- </menu>
-</interface>
static void
example_app_startup (GApplication *app)
{
- GtkBuilder *builder;
- GMenuModel *app_menu;
const gchar *quit_accels[2] = { "<Ctrl>Q", NULL };
G_APPLICATION_CLASS (example_app_parent_class)->startup (app);
gtk_application_set_accels_for_action (GTK_APPLICATION (app),
"app.quit",
quit_accels);
-
- builder = gtk_builder_new_from_resource ("/org/gtk/exampleapp/app-menu.ui");
- app_menu = G_MENU_MODEL (gtk_builder_get_object (builder, "appmenu"));
- gtk_application_set_app_menu (GTK_APPLICATION (app), app_menu);
- g_object_unref (builder);
}
static void
<gresources>
<gresource prefix="/org/gtk/exampleapp">
<file preprocess="xml-stripblanks">window.ui</file>
- <file preprocess="xml-stripblanks">app-menu.ui</file>
<file preprocess="xml-stripblanks">gears-menu.ui</file>
<file preprocess="xml-stripblanks">prefs.ui</file>
</gresource>
GSettings *settings;
GtkWidget *stack;
+ GtkWidget *gears;
GtkWidget *search;
GtkWidget *searchbar;
GtkWidget *searchentry;
- GtkWidget *gears;
GtkWidget *sidebar;
GtkWidget *words;
};
GAction *action;
gtk_widget_init_template (GTK_WIDGET (win));
+
+ builder = gtk_builder_new_from_resource ("/org/gtk/exampleapp/gears-menu.ui");
+ menu = G_MENU_MODEL (gtk_builder_get_object (builder, "menu"));
+ gtk_menu_button_set_menu_model (GTK_MENU_BUTTON (win->gears), menu);
+ g_object_unref (builder);
+
win->settings = g_settings_new ("org.gtk.exampleapp");
g_settings_bind (win->settings, "transition",
g_signal_connect (win->sidebar, "notify::reveal-child",
G_CALLBACK (words_changed), win);
- builder = gtk_builder_new_from_resource ("/org/gtk/exampleapp/gears-menu.ui");
- menu = G_MENU_MODEL (gtk_builder_get_object (builder, "menu"));
- gtk_menu_button_set_menu_model (GTK_MENU_BUTTON (win->gears), menu);
- g_object_unref (builder);
-
action = g_settings_create_action (win->settings, "show-words");
g_action_map_add_action (G_ACTION_MAP (win), action);
g_object_unref (action);
"/org/gtk/exampleapp/window.ui");
gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, stack);
+ gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, gears);
gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, search);
gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, searchbar);
gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, searchentry);
- gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, gears);
gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, words);
gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, sidebar);
+<?xml version="1.0" encoding="UTF-8"?>
<interface>
<menu id="menu">
<section>
<attribute name="label" translatable="yes">_Words</attribute>
<attribute name="action">win.show-words</attribute>
</item>
+ <item>
+ <attribute name="label" translatable="yes">_Preferences</attribute>
+ <attribute name="action">app.preferences</attribute>
+ </item>
+ </section>
+ <section>
+ <item>
+ <attribute name="label" translatable="yes">_Quit</attribute>
+ <attribute name="action">app.quit</attribute>
+ </item>
</section>
</menu>
</interface>
<property name="title" translatable="yes">Preferences</property>
<property name="resizable">0</property>
<property name="modal">1</property>
- <child internal-child="vbox">
- <object class="GtkBox" id="vbox">
+ <child internal-child="content_area">
+ <object class="GtkBox" id="content_area">
<child>
<object class="GtkGrid" id="grid">
- <property name="margin-start">6</property>
- <property name="margin-end">6</property>
- <property name="margin-top">6</property>
- <property name="margin-bottom">6</property>
+ <property name="margin-start">12</property>
+ <property name="margin-end">12</property>
+ <property name="margin-top">12</property>
+ <property name="margin-bottom">12</property>
<property name="row-spacing">12</property>
- <property name="column-spacing">6</property>
+ <property name="column-spacing">12</property>
<child>
<object class="GtkLabel" id="fontlabel">
<property name="label">_Font:</property>
<property name="title" translatable="yes">Example Application</property>
<property name="default-width">600</property>
<property name="default-height">400</property>
+ <child type="titlebar">
+ <object class="GtkHeaderBar" id="header">
+ <property name="show-title-buttons">1</property>
+ <child type="title">
+ <object class="GtkStackSwitcher" id="tabs">
+ <property name="stack">stack</property>
+ </object>
+ </child>
+ <child type="end">
+ <object class="GtkToggleButton" id="search">
+ <property name="sensitive">0</property>
+ <property name="icon-name">edit-find-symbolic</property>
+ </object>
+ </child>
+ <child type="end">
+ <object class="GtkMenuButton" id="gears">
+ <property name="direction">none</property>
+ </object>
+ </child>
+ </object>
+ </child>
<child>
<object class="GtkBox" id="content_box">
<property name="orientation">vertical</property>
- <child>
- <object class="GtkHeaderBar" id="header">
- <child type="title">
- <object class="GtkStackSwitcher" id="tabs">
- <property name="stack">stack</property>
- </object>
- </child>
- <child type="end">
- <object class="GtkToggleButton" id="search">
- <property name="sensitive">0</property>
- <property name="icon-name">edit-find-symbolic</property>
- </object>
- </child>
- <child type="end">
- <object class="GtkMenuButton" id="gears">
- <property name="direction">none</property>
- <style>
- <class name="image-button"/>
- </style>
- </object>
- </child>
- </object>
- </child>
<child>
<object class="GtkSearchBar" id="searchbar">
<child>
--- /dev/null
+Step 9: Using properties
+++ /dev/null
-<interface>
- <menu id="appmenu">
- <section>
- <item>
- <attribute name="label" translatable="yes">_Preferences</attribute>
- <attribute name="action">app.preferences</attribute>
- </item>
- </section>
- <section>
- <item>
- <attribute name="label" translatable="yes">_Quit</attribute>
- <attribute name="action">app.quit</attribute>
- </item>
- </section>
- </menu>
-</interface>
static void
example_app_startup (GApplication *app)
{
- GtkBuilder *builder;
- GMenuModel *app_menu;
const gchar *quit_accels[2] = { "<Ctrl>Q", NULL };
G_APPLICATION_CLASS (example_app_parent_class)->startup (app);
gtk_application_set_accels_for_action (GTK_APPLICATION (app),
"app.quit",
quit_accels);
-
- builder = gtk_builder_new_from_resource ("/org/gtk/exampleapp/app-menu.ui");
- app_menu = G_MENU_MODEL (gtk_builder_get_object (builder, "appmenu"));
- gtk_application_set_app_menu (GTK_APPLICATION (app), app_menu);
- g_object_unref (builder);
}
static void
<gresources>
<gresource prefix="/org/gtk/exampleapp">
<file preprocess="xml-stripblanks">window.ui</file>
- <file preprocess="xml-stripblanks">app-menu.ui</file>
<file preprocess="xml-stripblanks">gears-menu.ui</file>
<file preprocess="xml-stripblanks">prefs.ui</file>
</gresource>
GSettings *settings;
GtkWidget *stack;
+ GtkWidget *gears;
GtkWidget *search;
GtkWidget *searchbar;
GtkWidget *searchentry;
- GtkWidget *gears;
GtkWidget *sidebar;
GtkWidget *words;
GtkWidget *lines;
GAction *action;
gtk_widget_init_template (GTK_WIDGET (win));
+
+ builder = gtk_builder_new_from_resource ("/org/gtk/exampleapp/gears-menu.ui");
+ menu = G_MENU_MODEL (gtk_builder_get_object (builder, "menu"));
+ gtk_menu_button_set_menu_model (GTK_MENU_BUTTON (win->gears), menu);
+ g_object_unref (builder);
+
win->settings = g_settings_new ("org.gtk.exampleapp");
g_settings_bind (win->settings, "transition",
g_signal_connect (win->sidebar, "notify::reveal-child",
G_CALLBACK (words_changed), win);
- builder = gtk_builder_new_from_resource ("/org/gtk/exampleapp/gears-menu.ui");
- menu = G_MENU_MODEL (gtk_builder_get_object (builder, "menu"));
- gtk_menu_button_set_menu_model (GTK_MENU_BUTTON (win->gears), menu);
- g_object_unref (builder);
-
action = g_settings_create_action (win->settings, "show-words");
g_action_map_add_action (G_ACTION_MAP (win), action);
g_object_unref (action);
"/org/gtk/exampleapp/window.ui");
gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, stack);
+ gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, gears);
gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, search);
gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, searchbar);
gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, searchentry);
- gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, gears);
gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, words);
gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, sidebar);
gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppWindow, lines);
+<?xml version="1.0" encoding="UTF-8"?>
<interface>
<menu id="menu">
<section>
<attribute name="label" translatable="yes">_Lines</attribute>
<attribute name="action">win.show-lines</attribute>
</item>
+ <item>
+ <attribute name="label" translatable="yes">_Preferences</attribute>
+ <attribute name="action">app.preferences</attribute>
+ </item>
+ </section>
+ <section>
+ <item>
+ <attribute name="label" translatable="yes">_Quit</attribute>
+ <attribute name="action">app.quit</attribute>
+ </item>
</section>
</menu>
</interface>
<property name="title" translatable="yes">Preferences</property>
<property name="resizable">0</property>
<property name="modal">1</property>
- <child internal-child="vbox">
- <object class="GtkBox" id="vbox">
+ <child internal-child="content_area">
+ <object class="GtkBox" id="content_area">
<child>
<object class="GtkGrid" id="grid">
- <property name="margin-start">6</property>
- <property name="margin-end">6</property>
- <property name="margin-top">6</property>
- <property name="margin-bottom">6</property>
+ <property name="margin-start">12</property>
+ <property name="margin-end">12</property>
+ <property name="margin-top">12</property>
+ <property name="margin-bottom">12</property>
<property name="row-spacing">12</property>
- <property name="column-spacing">6</property>
+ <property name="column-spacing">12</property>
<child>
<object class="GtkLabel" id="fontlabel">
<property name="label">_Font:</property>
<property name="title" translatable="yes">Example Application</property>
<property name="default-width">600</property>
<property name="default-height">400</property>
- <child>
- <object class="GtkBox" id="content_box">
- <property name="orientation">vertical</property>
+ <child type="titlebar">
+ <object class="GtkHeaderBar" id="header">
+ <property name="show-title-buttons">1</property>
<child>
- <object class="GtkHeaderBar" id="header">
- <child>
- <object class="GtkLabel" id="lines_label">
- <property name="visible">0</property>
- <property name="label" translatable="yes">Lines:</property>
- </object>
- </child>
- <child>
- <object class="GtkLabel" id="lines">
- <property name="visible">0</property>
- </object>
- </child>
- <child type="title">
- <object class="GtkStackSwitcher" id="tabs">
- <property name="stack">stack</property>
- </object>
- </child>
- <child type="end">
- <object class="GtkToggleButton" id="search">
- <property name="sensitive">0</property>
- <property name="icon-name">edit-find-symbolic</property>
- </object>
- </child>
- <child type="end">
- <object class="GtkMenuButton" id="gears">
- <property name="direction">none</property>
- <style>
- <class name="image-button"/>
- </style>
- </object>
- </child>
+ <object class="GtkLabel" id="lines_label">
+ <property name="visible">0</property>
+ <property name="label" translatable="yes">Lines:</property>
</object>
</child>
+ <child>
+ <object class="GtkLabel" id="lines">
+ <property name="visible">0</property>
+ </object>
+ </child>
+ <child type="title">
+ <object class="GtkStackSwitcher" id="tabs">
+ <property name="stack">stack</property>
+ </object>
+ </child>
+ <child type="end">
+ <object class="GtkToggleButton" id="search">
+ <property name="sensitive">0</property>
+ <property name="icon-name">edit-find-symbolic</property>
+ </object>
+ </child>
+ <child type="end">
+ <object class="GtkMenuButton" id="gears">
+ <property name="direction">none</property>
+ </object>
+ </child>
+ </object>
+ </child>
+ <child>
+ <object class="GtkBox" id="content_box">
+ <property name="orientation">vertical</property>
<child>
<object class="GtkSearchBar" id="searchbar">
<child>
subdir('application7')
subdir('application8')
subdir('application9')
-subdir('application10')
projects / gtk4.git / commitdiff
![docs/reference/gtk/images/getting-started-app1.png](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=blob;f=docs/reference/gtk/images/getting-started-app1.png;h=a382510bbdfbfe6c47117c0b985ac188a50d6927;hb=d2430c70bd2166f086214880043258cf19bb3e8f){kind=link}
![history](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=history;f=docs/reference/gtk/images/getting-started-app1.png;hb=d2430c70bd2166f086214880043258cf19bb3e8f){kind=link}
![docs/reference/gtk/images/getting-started-app2.png](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=blob;f=docs/reference/gtk/images/getting-started-app2.png;h=40f71c5e3ff70a3c7ea7a40390b113c055d71cf4;hb=d2430c70bd2166f086214880043258cf19bb3e8f){kind=link}
![history](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=history;f=docs/reference/gtk/images/getting-started-app2.png;hb=d2430c70bd2166f086214880043258cf19bb3e8f){kind=link}
![docs/reference/gtk/images/getting-started-app3.png](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=blob;f=docs/reference/gtk/images/getting-started-app3.png;h=22b5a3683cd2ab4c12e0e95563be8b977a6913d7;hb=d2430c70bd2166f086214880043258cf19bb3e8f){kind=link}
![history](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=history;f=docs/reference/gtk/images/getting-started-app3.png;hb=d2430c70bd2166f086214880043258cf19bb3e8f){kind=link}
![docs/reference/gtk/images/getting-started-app4.png](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=blob;f=docs/reference/gtk/images/getting-started-app4.png;h=fcfc05dd7847296006de26ec8a226e6c7d5dd2cb;hb=d2430c70bd2166f086214880043258cf19bb3e8f){kind=link}
![history](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=history;f=docs/reference/gtk/images/getting-started-app4.png;hb=d2430c70bd2166f086214880043258cf19bb3e8f){kind=link}
![docs/reference/gtk/images/getting-started-app6.png](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=blob;f=docs/reference/gtk/images/getting-started-app6.png;h=cdb20aa9493e5b329bed722696610c43de6df0eb;hb=d2430c70bd2166f086214880043258cf19bb3e8f){kind=link}
![history](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=history;f=docs/reference/gtk/images/getting-started-app6.png;hb=d2430c70bd2166f086214880043258cf19bb3e8f){kind=link}
![docs/reference/gtk/images/getting-started-app7.png](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=blob;f=docs/reference/gtk/images/getting-started-app7.png;h=2e3c375d76f53838ada87c9a6b89f67ad146eeb4;hb=d2430c70bd2166f086214880043258cf19bb3e8f){kind=link}
![history](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=history;f=docs/reference/gtk/images/getting-started-app7.png;hb=d2430c70bd2166f086214880043258cf19bb3e8f){kind=link}
![docs/reference/gtk/images/getting-started-app8.png](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=blob;f=docs/reference/gtk/images/getting-started-app8.png;h=b86771102e13e50bde8ca3d1fd9f77be0211f9c8;hb=d2430c70bd2166f086214880043258cf19bb3e8f){kind=link}
![history](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=history;f=docs/reference/gtk/images/getting-started-app8.png;hb=d2430c70bd2166f086214880043258cf19bb3e8f){kind=link}
![docs/reference/gtk/images/getting-started-app9.png](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=blob;f=docs/reference/gtk/images/getting-started-app9.png;h=3a39c30dbcdb443e5832230d22fc26b69aa462a9;hb=d2430c70bd2166f086214880043258cf19bb3e8f){kind=link}
![history](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=history;f=docs/reference/gtk/images/getting-started-app9.png;hb=d2430c70bd2166f086214880043258cf19bb3e8f){kind=link}
![a/docs/reference/gtk/images/getting-started-app1.png](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=blob;f=docs/reference/gtk/images/getting-started-app1.png;h=bf33a44ad3c3498719e97e28c3912911b727fb23){kind=link}
![a/docs/reference/gtk/images/getting-started-app2.png](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=blob;f=docs/reference/gtk/images/getting-started-app2.png;h=ca4c0e1e4cf0dcf7512b7be77378d64fcf66be64){kind=link}
![a/docs/reference/gtk/images/getting-started-app3.png](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=blob;f=docs/reference/gtk/images/getting-started-app3.png;h=164ae62c80d19ecb772d3815c53c3fa21993d8d0){kind=link}
![a/docs/reference/gtk/images/getting-started-app4.png](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=blob;f=docs/reference/gtk/images/getting-started-app4.png;h=99d05913c26c490bd2e58b8502aa09e7a070f97a){kind=link}
![a/docs/reference/gtk/images/getting-started-app6.png](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=blob;f=docs/reference/gtk/images/getting-started-app6.png;h=0e89713af5f6856a13e187dbfd1afb56f438f81a){kind=link}
![a/docs/reference/gtk/images/getting-started-app7.png](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=blob;f=docs/reference/gtk/images/getting-started-app7.png;h=1490a1b3dca47731549e05314a713d55ba076a1c){kind=link}
![a/docs/reference/gtk/images/getting-started-app8.png](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=blob;f=docs/reference/gtk/images/getting-started-app8.png;h=00ff9b555452a9a6494f93275b0069bc9fd959ba){kind=link}
![a/docs/reference/gtk/images/getting-started-app9.png](/"http:/www.example.com/cgi/"https:/www.github.com/"bookmarks://"cascade.html?p=gtk4.git;a=blob;f=docs/reference/gtk/images/getting-started-app9.png;h=472da3e08143d3b083287ca07d829b7b3e4e368d){kind=link}